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Copyright 

This manual and the software described in it are 
copyrighted with all rights reserved. Under the 
copyright laws, this manual or the software may 
not be copied, in whole or part, without written 
consent of Dove, except in the normal use of the 
software or to make a backup copy. The same 
proprietary and copyright notices must be affixed 
to any permitted copies as were affixed to the 
original. This exception does not allow the copies to be 
made for others, whether or not sold, but all of the 
material purchased (with all backup copies) may be 
sold, given, or loaned to another person. Under 
the law, copying includes translating into another 
language or format. 


You may use the software on any computer owned 
by you, but extra copies cannot be made for this 
purpose. For some products, a multiuse license 
may be purchased to allow the software to be used 
on more than one computer owned by the 
purchaser, including a shared-disk system. (Contact 
your authorized Dove dealer for information on 
multiuse licenses). 


Dove Computer Corporation 
1200 North 23rd Street 
Wilmington, NC 28405 
(919) 763-7918 


Dove and the Dove logo are registered trademarks 
of the Dove Computer Corporation. MacSnap, and 
MacSnap Plus 2, are trademarks of Dove Computer 
Corporation. Apple, and the Apple logo are 
registered trademarks of Apple Computer, Inc. 

The Macintosh logo, AppleIalk, ImageWriter, 
LaserWriter and MacDraw, are trademarks of Apple 
Computer, Inc. and along with other Apple software, 
is licensed to Dove for distribution with MacSnap. 


Limited Warranty on Media and Manuals 

If you discover physical defects in the media on 
which the software included with this product is 
distributed, or in the manuals distributed with the 
software, Dove will replace the media or manual at 
no charge to you, provided you return the item to 
be replaced with proof of purchase to Dove or an 
authorized Dove dealer during the ninety day period 
after you purchased the software. In some countries 
the replacement period may be different; check with 
your authorized Dove dealer. 


Part Number M1010 


ALL IMPLIED WARRANTIES ON THE 
MEDIA AND MANUAL, INCLUDING 
IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE, ARE LIMITED IN 
DURATION TO NINETY DAYS FROM THE 
DATE OF THE ORIGINAL RETAIL 
PURCHASE OF THIS PRODUCT. 


Even though Dove has tested the software and 
reviewed the documentation, DOVE MAKES NO 
WARRANTY OR REPRESENTATION, 
EITHER EXPRESS OR IMPLIED, WITH 
RESPECT TO THIS SOFTWARE, ITS 
QUALITY, PERFORMANCE, 
MERCHANTABILITY OR FITNESS FOR A 
PARTICULAR PURPOSE, AS A RESULT, 
THIS SOFTWARE IS SOLD “AS IS”, AND 
YOU, THE PURCHASER, ARE ASSUMING 
THE ENTIRE RISK AS TO ITS QUALITY 
AND PERFORMANCE. 


APPLE COMPUTER MAKES NO 
WARRANTY OR REPRESENTATION, 
EITHER EXPRESS OR IMPLIED, WITH 
RESPECT TO ANY SOFTWARE LICENSED 
TO DOVE, ITS QUALITY, PERFORMANCE 
MERCHANTABILITY OR FITNESS FOR A 
PARTICULAR PURPOSE. 


IN NO EVENT WILL DOVE BE LIABLE FOR 
DIRECT, INDIRECT, SPECIAL 
INCIDENTAL, OR CONSEQUENTIAL 
DAMAGES RESULTING FROM ANY 
DEFECT IN THE SOFTWARE OR ITS 
DOCUMENTATION, even if advised of the 
possibility of such damages. In particular, Dove 
shall have no liability for any programs or data 
stored in or used with Dove products, including the 
costs of recovering such program or data. 


THE WARRANTY AND REMEDIES SET 
FORTH ABOVE ARE EXCLUSIVE AND IN 
LIEU OF ALL OTHERS, ORAL OR 
WRITTEN, EXPRESS OR IMPLIED. No Dove 
dealer, agent or employee is authorized to make 
any modification, extension, or addition to this 
warranty. 


Some states do not allow the exclusion or limitation 
of implied warranties or liability for incidental or 
consequential damages, so the above limitation or 
exclusion may not apply to you. This warranty 
gives you specific legal rights, and you may also 
have other rights which vary from state to state. 


See inside back cover for warranty information on 
hardware products. 


©1988 Dove Computer Corporation 


RamSnap™ 
A RAM Disk and Disk Cache Utility 


RamSnap is included with all MacSnap™ productivity enhancement products from 
Dove Computer Corporation. 

RamSnap is not necessary for the proper use of your MacSnap memory product, it is 
a tool to help you streamline your system and, as a result, improve your 
productivity. 


About This Booklet 
This booklet has been written for both the novice and the expert. The first 
section is an overview of RamSnap. The next two sections describe the 
functions and benefits of RAM (Random Access Memory) disks and disk 
caches. "Using RamSnap" is a guide to the use of RamSnap that 
familiarizes the user with its procedures and capabilities. Appendix A is a 
step-by step, sample installation using MacWrite™. A reference guide to 
RamSnap's features is found in the next section. The last section is a 
glossary of terms used in this manual. 


This booklet assumes that you have had experience using the Apple 
Macintosh computer. If you haven't, please refer to the Owner's Guide that 
came with your computer to learn the basics. 


It is helpful to read through this booklet completely before setting up and 
using RamSnap. If you need answers to technical questions or updated 
product information regarding RamSnap or any other Dove product, please 
call our Technical Support Department. 


MacSnap and RamSnap™ are trademarks of Dove Computer Corporation. 

Apple® is a registered trademark of Apple Computer, Inc. 

Macintosh™ and MacWrite™ are trademarks licensed to Apple Computer, Inc. 
Copyright© 1988 Dove Computer Corporation. 
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Welcome to RamSnap 


RAM Disk 


Disk Cache 


RamSnap is one of the most capable productivity enhancers available for the 
Macintosh. It is an integrated RAM disk and disk cache that allows you to 
take maximum advantage of available memory and processing power. You 
can use all of your present software without hardware changes. With 
RamSnap you'll think that you're using a "super" Macintosh. 


Benchmark tests show that your present software can run two to ten times 
faster when using RamSnap. Even a plain 512K Mac can run faster, and 
the more capable your hardware, the greater your speed increase. Best of 
all, RamSnap performs all this magic in the background, transparent to you. 


RamSnap will work with the 512K Macintosh, Macintosh Plus, SE and 
Macintosh II. It takes advantage of memory up to 8192K. RamSnap will 
automatically detect the amount of memory available and adjust itself for 
optimum operation. 


RAM disk software makes the computer "think" that some of its RAM is a 
disk drive. It is a utility disk that acts as a "mini hard drive" to free your 
Mac's internal disk drive so that you have access to your system files and 
can run your applications without the interruption of switching disks. It is 
easy to use. Like a regular disk, documents and applications can be copied 
to and from the RAM disk. Entire files are copied onto the RAM disk, and 
any subsequent access of any part of those files is lightning fast. 


Using the disk cache can significantly improve the speed of your work. 
The way a cache works is simple. Normally, every time a piece of an 
application is needed, it is copied from the physical disk into RAM. The 
application stores some of the information that it needs in a part of memory 
you reserve just for caching. So that the next time the same piece of 
information is called for, it doesn't have to go to the disk, the cache 
accesses it more quickly from its own RAM. 


RamSnap uses a combination of the RAM disk and disk cache to maximize 
your productivity. You can keep non-changing items (for instance, the 
System and Finder or an application) in a RAM disk, while caching the 
changeable items (your documents). Using the disk cache, however, takes 
away from the memory available to run your applications and slows your 
work. With programs that require large amounts of memory, for example, 
you want to use it sparingly, if at all. 


Due to the processing required when a disk cache does all of its internal 
housekeeping, a cache offers little speed increase when used with a very 
fast storage device, such as a hard disk drive, connected to the SCSI (Small 
Computer Systems Interface). 
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NOTE 
In accordance with recommendations by Apple Computer Corporation, 
Dove Computer Corporation is distributing RamSnap without a System 
Folder. Apple prefers that users obtain the latest copy of the System and 
associated files from an authorized Apple dealer. 


RamSnap is compatible with all Apple Systems beginning with System 3.2 
and Finder 5.3, except version 6.0 and Finder 6.1. We will re-evaluate this 
incompatibility as soon as version 6.01 is available. 


Using RamSnap 
RamSnap is a 400 K disk with a RamSnap v1.3 application, a TeachText 
application, and a Read Me!!! document on it. TeachText allows you to 
access the Read Me!!! document which contains any updated instructions or 
information about RamSnap. 


Setting Up a Work Disk 
If you use a hard disk you already have very quick access to your 
applications and data. RamSnap is most efficient when used with slow 
storage devices such as floppy disk drives. Before doing anything else, 
make a backup copy of the RamSnap Disk and put the original in a safe 
place. You may already have a work disk with a System and Finder that 
you are currently using; in which case, you may simply copy the RamSnap 
application onto it. You may, however, want to create a new work disk 
with RamSnap. Begin building it by copying RamSnap, a System, and 
Finder onto a blank disk. (The System and Finder you use will determine 
whether you need a 400K or 800K disk.) Then copy the applications that 
you use most often onto the work disk. Shut down your Macintosh and 
Start it up again with the RamSnap Work Disk. 


Opening RamSnap 


When the Finder appears, choose the RamSnap icon and open it. After a 
few moments, your screen will look similar to this: 


é File i 


RamSnap™ . p 
{X] Make Ram Disk Startup Disk 
Finder 


General X] UnMount the Volume 
ImageWriter 

Key Layout 

Keyboard 832K OK 944K 
Laser Prep 

LaserWriter 

Monitors 

Mouse 

QD Scrapbook File 

QD Sound 

QO Startup Device 

QO StartupScreen 

D System 

606K _ Selected Ram Disk Cache 


DOOUDUDODOGDOCDB 


There are three main sections to the screen; the file selection box, the option selection check boxes, and the memory 
setting scroll bars. By using the RAM disk scroll bar and the file selection box, you can choose the size of the RAM 
disk and the files installed in it. The cache scroll bar sets the size of the cache. 


Choosing Files for the RAM Disk 


NOTE 


The next step is to choose the files to be placed into the RAM disk. 
Clicking on a file's name will select it (and dragging through the list will 
select multiple files). A file is de-selected by clicking on its name once 
again (no Shift-clicking is required). As files are selected, the total size of 
the selected files is determined and displayed below the file selection box. 


When run under HFS, folders will be listed in the box along with files. By 
double-clicking on a folder's name or icon, a folder can be opened to gain 
access to its contents. Notice that the folder's icon is now opened, and its 
contents appear beneath it. The contents also have a "." in front of their 
name to signify that they are at a lower level. At each lower level, an 
additional "." is added before the name to represent the nesting, as shown 
below. If a folder is selected by clicking on its name once (its icon remains 
closed), the folder and all of its contents are selected. 


=) Excel Folder 

=). Customer Folder 
e=y.. Northeast Folder 
D ... Joisey 

.. South Folder 


(. Parts Folder 
© Helix Folder 
© Paint Folder 
© System Folder 


94K Selected 


After selecting the files/folders you want installed into the RAM disk, check 
their total size. You can adjust the RAM disk size setting to match, or 
de-select some files. 


There is no need to include RamSnap in your selection. The application is 
already open and would consume memory unnecessarily. 


Ram Disk Cache Free 
Initial scroll bars when starting RamSnap on an MFS 512K Mac. 


Setting the RAM Disk Size 
To set up a RAM disk/cache, you should first set the RAM disk size using 
the RAM disk scroll bar. Notice that as you change the RAM disk size the 
Free Memory setting adjusts accordingly. So, as you take memory for use 
as a RAM disk, it becomes unavailable to applications as standard RAM. 
As a starting point, set the disk size using about half of the available 
memory. You will come back and fine-tune this setting after you have 
chosen the files to go in RAM. 


Co Excel Folder 
© Helix Folder 
© Paint Folder 
O System Folder 


153 K Selected 


Setting the Cache Size 
The cache size is set in the same way as the RAM disk size. Note the 
amount of free memory available as you change the size. This is the amount 
of memory left over after you set up your RAM disk/cache set. Remember, 
it is the only memory in which your applications will be able torun. A 


WARNING 


good gauge for determining the optimum setting is to go by the size of the 
largest program you want to include. If the free memory available is 
insufficient, resize the cache or cut down the RAM disk size after 
de-selecting some files. Note that at any time before using or saving a RAM 
disk/cache set you can resize both the RAM disk and the cache; you can 
even use one independent of the other. 


When using the RamSnap, be sure that the RAM Cache setting on the 
Control Panel desk accessory of your Macintosh is OFF. Although nothing 
catastrophic will happen if it is left on, it would be a waste of precious 
memory to cache a cache or a RAM disk! 


Choosing a Launch Application 


Options 


RamSnap allows you to choose an application to be automatically launched 

when a set is installed. Click on the icon of the application that you want to 
be the launch application, and the icon will turn into an arrow. To choose a 
different application, de-select the current startup icon and select a new one. 


There are two options on RamSnap that make your Macintosh work even 
faster. These options are available only if both the System and the Finder 
are specifically chosen to be included in the RAM disk (the System Folder 
must be opened to select them). 

"Make RAM Disk Startup Disk" will allow your RAM disk to be 

the startup disk when you return to the Finder. In other words, the RAM 
disk will be the default disk, making all subsequent calls to the System and 
Finder very fast. 

The "UnMount the Volume" option tells your Macintosh to eject the 
disk from which the RamSnap set was launched. If you unmount a floppy 
disk, it will be ejected after the set is installed and your disk drive is free to 
accept other disks. 


Saving and Using a RAM Disk/Cache Set 


After choosing the settings and options, you can use the RAM disk/cache 
set in either of the following two ways: 


2 File 
Install Current Setup 
Install Set... 
Save Set... 


Choose a Volume... 
Quit 


If the set is one you plan to use often, choose "Save Set..." from the 
"File" menu to save the set. RamSnap looks for the default set named 
"SnapStart” at startup and automatically loads the set saved in that file. The 
RamSnap program must be set as the startup program and the SnapStart Set 
must be in the same folder as RamSnap for this autoload to occur. The 


10 


autoload process may be bypassed by holding down the option key during 
startup. You may also save sets with other names. This allows you to 
create different sets for each type of work you do. 


Install Current Setup 
Install Set... 

Save Set... 

Choose a Volume... 
Quit 
You could also choose "Install Current Setup” if the set you just 
created is temporary. Thus, the set would be installed, then forgotten when 


you shut down. However, if you choose this option, you will be presented 
with a dialog box allowing you the opportunity to save the set after use. 


Remove Current Setup 
Install Set... 
Save Set... 

Choose a Volume... 
Quit 


If RamSnap is launched while some previously created settings are already 
installed (which is also true in the unlikely event that you attempt to run a 
saved set while one is already installed), RamSnap opens and the "Install 
Current Setup" becomes "Remove Current Setup". If this 

menu selection is chosen, RamSnap will attempt to clear out the current 
RAM disk and/or cache. However, if the RAM disk has some data in it, 
RamSnap will ask you to clear out the RAM disk and will not remove it. 
This is a protection feature to keep you from accidentally trashing 
information you need. Go back to the Finder and drag the files from within 
the RAM disk into the Trash (or select the RAM disk and choose "Erase 
Disk..."). Restart RamSnap. Now the current setup may be removed. 


lastall Current Setup 


Install Set... 
Save Ser... 
Choose a Volume... 
Quit 
A previously-saved set can be installed by choosing "Install Set..." If 


you choose this item, you will be given the option of saving the current 
settings if there are any. 


NOTE 


Choosing a Volume 


Quitting RamSnap 


NOTE 


If you try to install a set that calls for an unmounted volume (a disk 
that is not in the Macintosh), RamSnap will not load the set; it will 
open to the settings screen. Ifa file called for is not available, the 
rest of the set will be installed as specified. 


This option allows you to choose a different volume (disk) from which to 
select files. As can be seen in the picture of the opening screen (page 6), the 
volume name from which the files are listed is displayed above the file 
selection box. Note that you can work with only one volume per set. 


lastali Current Setup 
Install Set... 
Save Ser. 


Choose a Volume... | 


Choose "Quit" if you are finished using RamSnap. If your current 
settings have not already been saved when you attempt to quit, you will be 
asked if you want to save them. 


insigh Current Setup 
Install Set... 

Sape ser. 

Choose a Volume... 


In case of a system error, RamSnap will try to allow you to return to the 
Finder. If this is possible, the "Resume" button on the "Bomb" dialog 
box will be active. In most cases, clicking on this button will bring you 
back to the Finder. At this point, back up anything on the RAM Disk that 
needs to be, as the computer may be unstable. 


Maintaining RamSnap 


Here are some notes on specific issues pertaining to the use of RamSnap: 


¢ Remember that in order to print, the Macintosh must have the printer 
icon on the same disk with its System and Finder. If you want to print 
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while using the RAM disk, install the required printer driver(s) initially. 
Most RAM Disk programs will not work with MultiFinder when it is 
used with Finder 6.0 and System 4.2. RamSnap, however, can be used 
with MultiFinder, but only if it is allowed to fulfill its memory 
requirements ahead of MultiFinder. To do this RamSnap must be 
configured as a startup disk that contains System 4.2 , Finder 6.0, and 
MultiFinder (plus any other files you choose), with Finder as the "Set 
Startup ..." option. Once booted, you can "Switch Launch" into 
MultiFinder by opening RamSnap, locating MultiFinder, holding down 
the Option and Control (clover) keys, and double-clicking on 
MultiFinder. 

If, at some point, you return to use your backup copy of RamSnap as a 
work disk, double click on the RamSnap icon when it appears, then 
select files and set up as you normally would. If you do not double click 
on the icon you will get the error "Source Volume Cannot Be Found". 
Should you ever want to put more than 800K of data on your RAM disk, 
it is possible. Set up your RAM disk as usual, insert the disk that 
contains the additional applications and drag their icons onto the 
RamSnap icon. This is only temporary; the additional applications will 
not be saved on RamSnap. 

When you use RamSnap with the Macintosh II, insure that your 
machine is in the black and white mode with only two shades of grey 
selected. This adjustment is made by double-clicking on the monitor 
icon in the Control Panel. 


Appendix A 


Reference 


Follow these steps for a typical RamSnap installation with MacWrite: 


SN mn hw 


. Insert your System disk to boot-up your computer. Open the 


highlighted disk icon to show the contents of the disk. Hold down the 
"command" and "e" keys to eject the disk. 


. Insert your RamSnap disk, open it and copy the RamSnap application 


onto your System disk. Hold down the "command" and "e" keys to 
eject the disk. 


. Insert the blank disk that will be your working RAM disk. 
. Drag the System, Finder, and RamSnap icons onto your working disk. 


Hold down the "command" and "e" keys to eject the disk. 


. Insert the disk with MacWrite on it. Drag the MacWrite icon onto the 


working disk. 


. Shut down your computer and restart using your new working disk. 
. Upon boot, your screen will open to directly into RamSnap (diagram, 


p.6). This is the screen from which you select the files that will be in 
your RAM disk. 


. Make your selections by highlighting the names of the files you want to 


include: System, Finder, and MacWrite. Adjust the first vertical scroll 
bar to set the size of your Ram Disk. Select the box in front of "Make 
RAM Disk Start Up Disk" and also the box in front of "Unmount the 
Volume". 


. Go to the "File" menu and select "Save Set". The screen will appear 


with the name SnapStart highlighted; leave the name as is and click on 
"Save". 


10. Go under "File" and select "Quit". Restart your computer with your 


new RAM disk. 


MENU ITEMS 


INSTALL CURRENT SETUP... Use current RAM disk/cache 
settings and throw them away after use. 


INSTALL SET... Install previously created RAM disk/cache set. 
SAVE SET... Save current settings as a document for later use. 


CHOOSE A VOLUME... Choose a volume from which to copy files 
into a RAM disk. 


QUIT... Exit RamSnap. 


RAM DISK SCROLL BAR Allows setting of RAM disk size from 0 to 


maximum available RAM. Minimum size is 100OKB. 


CACHE SCROLL BAR Allows setting of cache size from 0 to max 


available RAM. Minimum size is 32KB. 


"MAKE RAM DISK STARTUP DISK" CHECK BOX If checked, the 


RAM disk will be designated as the startup disk. The Macintosh will 
then use the RAM disk as the default disk whenever this RAM 
disk/cache set is used. 


"UNMOUNT A VOLUME" CHECK BOX If checked, the source volume 


(disk) will be ejected when the RAM disk/cache set is installed. 


14 


FILE SELECTION BOX Allows selection of files to be placed into RAM 
disk. Click on name to select a file or drag over names to select multiple 
files. Click again on the name to de-select a file. If HFS, folder icons 
accompany folder names. Click on folder name to select entire folder 
contents. Double-click to open a folder and allow selection of individual 
files within the folder. 


Glossary of Terms 


Desktop Where you see your files when using the Finder, it is built from 
file information each time the Finder is used. 

Disk Cache A "middleman" between physical disk and RAM; holds 
frequently used routines in allocated area in RAM for quicker response. 
It also keeps the disk file up-to-date. 

Floppy Disk The 31/," hard-covered disks that are used in your Mac. 
They are called floppies because the magnetic disk inside them is soft 
and floppy. 

Font D/A Mover A utility from Apple that allows installation and removal 
of fonts and desk accessories. 

HFS (Hierarchical File System) The Mac's multi-level filing system that 
allows you to organize the data stored on a disk by "nesting" it into 
folders. 

MFS (Macintosh Filing System) The original operating system's way of 
organizing files. It uses folders for visual organization only; that is, the 
operating system sees them in a flat format, not nested in folders. 

Mount Volume Make the Mac "see" that a disk is connected. 

MultiFinder An operating system for the Mac Plus, SE, and II that allows 

you to have several applications open at the same time. 

Physical Disk An actual storage device as opposed to a RAM disk. 

RAM Disk A certain amount of RAM allocated for the temporary storage 
of files for increased access speed. 

RAM Disk/Cache Set A document created by RamSnap which, when 
installed, will set up a RAM disk and/or disk cache per the saved 
specifications. 

SCSI (Small Computer Systems Interface) An industry-standard 
interface for connecting computers with various high-speed peripherals 
such as hard drives or scanners. 

Shift-click A selection method used by some Macintosh applications. 
Performed by holding down the Shift key while mouse-clicking on an 
item. Typically used to add or remove items to a previous selection. 
Not required when using RamSnap. 

UnMount Volume Make Mac eject a disk after it is installed. 

Volume A block of mass storage that usually refers to an entire hard disk 
drive, but can refer to a piece of a hard disk. 

Volume Number A label for a disk (including a RAM disk) used by the 
operating system to keep track of what you are doing with your disks. 
"1" is the internal floppy disk drive, "2" is the external floppy disk 
drive, and the rest depend on which hard disks you are using and where 
they are connected. 
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